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Important User Information 


Because of the variety of uses for the products described in this publication, 
those responsible for the application and use of this control equipment must 
satisfy themselves that all necessary steps have been taken to assure that each 
application and use meets all performance and safety requirements, including 
any applicable laws, regulations, codes and standards. 


The illustrations, charts, sample programs and layout examples shown in this 
guide are intended solely for purposes of example. Since there are many 
variables and requirements associated with any particular installation, the 
Allen-Bradley Company, Inc. does not assume responsibility or liability (to 
include intellectual property liability) for actual use based upon the examples 
shown in this publication. 


Allen-Bradley Publication SGI-1.1, “Safety Guidelines for the Application, 
Installation and Maintenance of Solid State Control” (available from your local 
Allen-Bradley office) describes some important differences between solid-state 
equipment and electromechanical devices which should be taken into 
consideration when applying products such as those described in this 
publication. 


Reproduction of the contents of this copyrighted manual, in whole or in part, 
without written permission of the Allen-Bradley Company Inc. is prohibited. 


Throughout this manual we use notes to make you aware of safety 
considerations: 


ATTENTION: Identifies information about practices or U 
circumstances that can lead to personal injury or death, property 
damage or economic loss. 


Attentions help you: 


» identify a hazard 
» avoid the hazard 
» recognize the consequences 


Important: Identifies information that is especially important for 
successful application and understanding of the product. 


ControlView, ControlView 300, Data Highway Plus, DH+, Data Highway II, DHII, LAN/PC and SLC 
are trademarks and PLC, PLC-2, and PLC-3 are registered trademarks of Allen-Bradley Company, Inc. 


Token Ring is a trademark and IBM, NetBIOS, AT, PS/2, EGA, VGA, and PC-DOS are registered 
trademarks of International Business Machines Corporation 


Mouse GRAFIX is a trademark of Dynapro Systems Inc. 
Microsoft, MS, MS-DOS, QuickC, and MASM are registered trademarks of Microsoft Corporation 
dBASE is a trademark of Ashton-Tate 


Summary of Changes 


Summary of Changes 
Changes from Release 2.0 to The following changes have been made to the Data Logger option and the 
3.0 Data Logger User Manual since release 2.0: 


For information on this new feature: 


Installation instructions for the Data Logger option have been moved to 
the ControlView Installation Manual. 


You can log string tag values to the log file. 
Up to 150 models can run at the same time (the former limit was 20). 


An Action field was added to the model definition window allowing you to 
specify a command or macro that is run each time a snapshot is taken. 


An Action field was added to the export template window allowing you to 
specify a command or macro that is run each data is exported. 


There are now three, instead of only one, file formats for exported Data 
Logger files. 


The DATALOGON command can now suppress the verification message 
and start silently, with the new /S parameter. 


There are now three options for exporting data: export in foreground, 
export in background and notify when finished, and export silently in the 
background. 


Support for snapshots on demand with the DATALOGSNAPSHOT 
command was added. 


Refer to: 
ControlView Installation Manual 


Chapter 1 
Chapter 1 
Chapter 2 


Appendix B 
Appendixes A & B 
Appendix A 


Appendix B 


Appendix A 


The feature appeared in: 
software release 3.0 


software release 3.0 
software release 3.0 
software release 3.0 


software release 3.0 
software release 3.0 
software release 3.0 


software release 3.0 


software release 2.11 
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How to Use this Manual 


Preface 


Preface 


This manual describes the features and capabilities of the Data Logger 
option, a component of the Control View™ system. Data Logger software is 
used to save data from the current value database in “log files". The data 
can be as simple as the state of a single monitored point, measured once a 
minute, or as complex as the value of each point in a class of points, 
measured when the sum of two tags exceeds a preset constant. 


These log files can also be used with other ControlView application 
modules—with Trending, to analyze the log files and plot graphs of the 
data, with Reporting, to generate reports on plant floor activity, and with 
C-Toolkit programs. 


Conventions Used in This Manual 


This manual follows the same print conventions outlined in the 
ControlView Core User Manual. 


Audience 


Since the Data Logger is a part of Control View, you should be familiar 
with ControlView and have the ControlView Core User Manual available 
for reference. A complete list of related publications is contained in that 
manual. 
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Introduction 


r future reference. The 
values can be recorded: 


= at preset times 

a according to preset rules 

= on demand, in a snapshot 

= whenever a preset event occurs 


The data in the log files can be used by the Trending, Reporting and 
C-Toolkit options. 


When you set up Data Logger, you will create one or more models to 
collect data into log files. 


A model specifies which tag values to save, and when to save them. There 
is a limit of up to 1,000 tags per model, less if you are logging string tags. 
(The limit is 4,000 bytes of data per model.) Up to 150 models can collect 
data at one time, with a total limit of 80,000 bytes of data in all models. 


An individual sample rate can be specified for each model. ControlView's 
conditional expressions can also be used to log only selected samples of 
any given tag. 


Logged data can be: 

= converted to ASCII format for viewing 

» used by the Trending option to create graphic displays 

» used by the Reporting option to create reports 

= used by the Statistical Process Control option to create historical charts 

= exported for use with popular database packages. Data Logger 2.0 and 
later software includes a special Date Format field to make exported 


Data Log files compatible with a wide variety of software packages 


= read or updated by a C-Toolkit task 
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Define a New Model 


Creating a Model 


Data logging is a process that saves specific tag values under specific 
conditions. These values and conditions are defined by a model. Several 
models can run at once, so you can set models for groups of related tags, 
and reuse the same models in different combinations and for different 
applications. A model is composed of a definition and a tag list. 


The model defines the size and number of log files to use, and the rate at 
which tag values are logged to disk. 


The tag list identifies specific tag values and, optionally, expressions 
that define the conditions under which tags will be logged. Tags without 
expressions will always be logged. 


1. In the Setup Menu, open the Configure menu and choose Edit Data 
Logger. 


2. Choose New. The following window appears. 
Figure 2.1 
The Data Logger Model Browser 


DL Edit-Model List Browse 
Modify 


Data Logger Model Directory: 
Current Database: 
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3. Choose Create to define a new model. The Create Data Logger 
Model window appears. 
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Figure 2.2 
Create Data Logger Model 


reate DataLogger Model 


DataLogger Model Directory: C:\ACCESS\DL 
Model Database: 


Model Name: [HH 


Model Description: [ —— — —  — — — — — — — — —— ———3À 
Sample Rate [  — ] (seconds) Snapshot Only: [ ] 


Maximum Number of Files: [L—— — —] Filesize in Kbytes: [ — 1 


When Data File is 
to be deleted: [Lr 


Action: 


ET 


% of expression space used: % Number of tags to be logged: 


Accept <+> ] Cancel <Esc>) 
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4. In this window, fill in the Model Name field; all the other fields are 
optional or have default values. 


The fields are: 
= Model Name — 
Type in a name (8 chars max) to identify the model. 
= Model Description 
Type in a description of the model for documentation purposes only. 


n XE 


Don't set the sample rate faster than the scan rate for the tags being 


logged, or you will be logging redundant data. 


Specify Yes in the Snapshot Only field if the model will be used only for 
snapshots, and never for periodic logging. This means: 


= the Sample Rate field is ignored 
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» your model will not log data when you start it 
a snapshots can be recorded quickly with little overhead 


= Maximum Number of Files 
Specify the number of files (4 to 200) in the log file set. 


The names for the data files are based on date and time. For example, 
the file named 90052814.450 — year 90, month 05, day 28, time 14:45. 
The last digit indicates how many files have been saved within the 
minute. 


Specify the size for each log file (from approximately 1 to 4000 Kb). 
Each snapshot consumes: 


l6bytes overhead, plus 

4 bytes for every tag logged, plus 

4 bytes for each analog tag logged, plus 

4bytes for each digital tag logged, plus 

n bytes for each string tag, where n is the length of the tag 


Specify what you want to happen when the last file in the set is about to 
be overwritten. Your choices are: 


= Overwrite: The operator receives no notice when the last file fills 
up and the first file is about to be overwritten. 


* Overwrite and Notify: The operator is warned that the last file is 
being opened. The operator has time to archive the log files before 
the first file is overwritten. 


= Stop and Notify: Logging stops and the operator is warned. 


a Overwrite if Archived: If the oldest file has been archived, 


logging continues. If not, a red error message is sent and logging 
stops. 


* Overwrite and Notify if Archived: If the oldest file has been 
archived, a green message advises the operator and logging 
continues. If not a red error message is sent and logging stops. 
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Important: If the oldest file is being used by Trending, or is being 
archived, Data Logger cannot delete the file, even if it has been 
configured to overwrite once the set is full. Instead, the system will 
create an additional file, using up more disk space than was originally 
configured. Each time Data Logger creates a new file, it will ask if you 
want to delete the extra “backlog” of files. The backlog of files is only 
deleted when the operator responds to this prompt. Thus, to make sure 
you don’t run out of disk space when running other options that use 
Data Logger data, have an operator available. The operator can then 
make sure the old files are overwritten. 


You may specify a command or macro that will be run each time the 
model writes a complete snapshot, whether logging periodically or in 
event driven mode. 


Important: The command or macro specified in the Action field is 
executed every time the snapshot is taken. If data is being logged 
frequently, or if the action takes a long time, system performance could 
suffer. Specify an action only if it is necessary to synchronize this action 
with the data logging process. 


% of Expression Space Used | 


The % of expression space used field displays the amount of space used by 
expressions. Each model is limited to 4k of conditional expressions. 
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Modify a Model Definition 
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To modify a definition, choose Modify from the DL Edit-Model List 
Browser. The following window appears: 


Figure 2.3 
The Modify Data Logger Model Window 


o Modify DataLogger Model 


DataLogger Model Directory: C:\ACCESS\DL 
Model Database: 


Model Name: [HS 
Model Description: [|] 
Sample Rate[ — | (seconds) Snapshot Only: C] 


Maximum Number of Files: [ 1] Filesize in Kbytes: Cl 


When Data File is 
to be deleted: Lo] 


Action: 


% of expression space used: % Number of tags to be logged: 


Accept <+>] Cancel <Esc>] 
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ATTENTION: If you modify a model, Control View will force 
you to delete the old data before it starts logging with the 


modified model. 


If you modify a model and then decide you don’t want to lose the data 
previously saved, you can either archive the old files before activating the 
new model, or change the model back to its original settings. 
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The Tag List 
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To create or modify the tag list, choose Tag List from the DL Edit-Model 
List Browser. The following window opens. 


Figure 2.4 
Data Logger Tag Browser 


DL Edit-Tag List Browser 


writing Duplicate | Add | Delete 
Model Description: 
Model Name: Conditional Expression Used: % 


Description 
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The Tag List names the points in the database you want to log, and when 
you want to log them. 


Adding a tag 


Choose Add. The following window will appear. 


Figure 2.5 
Add Tag To Model 


Tag Name: M 


Accept <+>) Cancel <Esc>] 
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= Tag Name 


Type in the name of the tag you want to log. The same tag can be used 
in different models. 
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= Condition 


Enter the Control View expression to specify when to log the tag's value. 
Refer to Chapter 3, Defining an Expression for the syntax of 
expressions. If you leave the Condition field blank the tag will always 
be logged. 


Important: If you specify a condition, the tag may not be logged to disk 


for every sample. Keep this in mind if you use this log file while creating a 
report template. 


Modifying a Tag 


To change a tag name or condition in the tag list, select the tag name and 
choose Modify. The following window appears. 


Figure 2.6 
Modify Data Logger Tag Information 


g Tag Information 


The Tag Name field contains the name of the tag you selected in the 


current database. The Condition field contains an expression defining the 
condition for the value to be logged. 


Duplicate a Tag 


If you want a series of tags to use the same condition, it is usually faster to 
duplicate an existing entry than to create a new one. 
Delete a Tag 


To remove an entry from the Tag List, select the listed tag and choose 
Delete from the menu. 
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Q 
Find a Tag 


To find an entry without scrolling through a long tag list, choose Find from 
the menu and type enough letters of the tag name to identify it. For 
example, to find a tag named TIC 33, you could type TIC. 


Important: After completing your actions in the Edit-Tag List Browser, 
press Esc to return to the Edit-Model List Browser (shown in Figure 2.1). 


Duplicate a Model Definition To copy a model and its associated tag list, select the model, choose 
Duplicate from the Edit Model List menu and type in the model name for 
the copy. 

Delete a Model Definition To delete a Data Logger model and its tag list, select the model name and 


choose Delete from the Edit Model List menu. You will be asked to 
confirm the deletion. 


Find a Model Definition To find a specific model in the Model List Browser, choose Find. A U 
window opens. Type in the first few letters of the model name and press 
Enter. This is faster than scrolling through the entire list if you have many 
models. 

Setup Choose Setup to specify the directory where log files will reside and to 


specify whether Data Logger will check the database to ensure that tags 
entered into a model do indeed exist. 


Figure 2.7 
Model Directory Set Up 


Model Directory Set Up 


Eu Model c Pathname: 


Verify Tag Names in Loaded DataBase: [NO] 
Verify Model Configuration 
each time model is started: CNO] 


Accept <+>] Cancel <Esc>] 
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C 
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Data Logger Model Directory Pathname 


In the Data Logger Model Directory Pathname field, you can specify a 
new directory, such as a drive on a network file server. If you are using the 
Trending option with Data Logger, Trending will be able to locate the log 
files in the new directory. 


Important: Whenever you configure a path name, be sure to include the 
drive letter. This is absolutely essential when running Control View in a 
multi-drive environment. 


Verify Tag Names in Loaded Database 


When you set Verify Tag Names in Loaded Database to YES, Data Logger 
checks that each tag name you specify in the Data Logger model actually 
exists in the current database. For this feature to work, the database must 
be loaded. Data Logger checks tag names only as you enter them in the 
editor, not those tag names already recorded in the model. So, if you 
created part of the model with this feature turned off, or if you changed the 
database, part of the model may contain invalid tag names. 


When you open Data Logger through the Setup menu, this feature is set to 
NO so that models can be created before the database is completed. 


Verify Model Configuration each time model is started 


When you load a model and start logging, Control View checks both the 
model and the database to make sure neither has changed. To prevent 
invalid data from being logged, Control View won't log data to an existing 
log file set if either the model or the database has changed. 


By choosing YES for this field, Control View performs a rigorous check on 
both the database and model to ensure that neither have changed. By 
choosing NO, the check is less rigorous, so logging can begin more 
quickly. Regardless of which you choose, if ControlView finds a change, it 
won't log new data to the old log files, instead it will ask you if you want 
to delete the existing data. 


Tag Values 


Constants 
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An expression is a mathematical equation that returns a value. The term 
refers to the entire equation whereas a segment of an expression is called a 
statement. 


Example: Expressions vs Statements 
(tagl * tag2) AND (tag3 / 2) 
is an expression 

(tag3 / 2) 


is a Statement 


Expressions are built from: 

= tag values 

= constants 

= mathematical, relational, logical, and bitwise operators 
a built-in functions 

* IF-THEN-ELSE program logic 


Important: All expressions return floating point values. 


A digital or analog tag can be included as part of an expression, or can 
stand alone as the entire expression. 


Important: String tags can not be used in an expression. 


Using, for example, the number 123.45, a constant could have any of the 
following formats: 

= integer (123) 

= floating point value (123.45) 

= scientific notation (0.12345E3) 
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Arithmetic Operators 
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Arithmetic operators perform basic mathematical operations with tag 
values. 


Table 3.A 
The Arithmetic Operators 


addition 


tag1 + tag2 
subtraction tag - tag2 
multiplication tag! * tag2 
/ 


MOD, % 


++ 


division tag1 / tag2 


modulus (remainder) tag! % tag2 
exponent 


The modulus operator is the remainder of one number divided by another. 
For example, the remainder of 13 divided by 5 is 3; so 13 06,5 2:3. 


Examples: Arithmetic Operators 
For these examples, tag] = 5 and tag2 = 7. 


tagl + tag2 
returns a value of 12 


tagl * tag2 
returns a value of 35 


tagl - tag2 
returns a value of —2 


tagl / tag2 
returns a value of 0.71 


tagli MOD tag2 
returns a value of 5 


tagl ** tag2 
returns a value of 78125 


Important: Operator precedence is explained later in this chapter. 


Relational Operators 


Logical Operators 
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Relational operators compare two values to provide a true or false result. If 
the statement is true, a value of 1 is returned. If false, 0 is returned. There 
are six relational operators; each has two different symbols. 


Table 3.B 
The Relational Operators 


Symbols 


equal 


tag1 = tag2 


NE, <> not equal tag1 <> tag2 
LT, < less than tag1 < tag2 
GT, > greater than tag1 > tag2 


less than or equal to tag1 <= tag2 


greater than or equal to tag! >= tag2 


Examples: Relational Operators 
For these examples, tag] = 5 and tag2 = 7. 


tagl > tag2 
is false, so the expression returns a 0 


tagl LE tag2 
is true, so the expression returns a 1 


tagl = 5 
is true, so the expression returns a 1 


Any statement which evaluates to a non-zero value is regarded as true. For 
example, the statement tag1, will be false if the value of tagl is 0, and true 
if tag] has any other value. 


Logical operators determine the validity of one or more statements. The 
operators return a value of 1 if the statement is true, or a value of 0 if false. 


There are three logical operators: AND, OR, and NOT. 


= AND returns a value of 1 if the statement to the right and to the left of 
the operator are both true 


* OR returns a value of 1 if either the statement to the left or to the right 
of the operator is true 


* NOT reverses the logical value of the statement it operates on 
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Important: When a statement is true, the expression editor returns a value 


of 1, otherwise it evaluates non-zero values as true. 


Table 3.C 
The Logical Operators 


Symbols 
AND, && 


Sami 
CER ELE 
CAR CEE 


negation NOT(tag1 > tag2) 


5) 


Examples: Logical Operators 
For these examples, tag] = 5 and tag2 = 7. 


(tagl « tag 2) AND (tagl = 5) 
returns a 1 since both statements are true 


tagl && tag2 
returns a 1 since neither tag] nor tag2 are O 


(tagl > tag2) OR (tagl = 5) 
returns a value of 1 since tag] = 5 is true 


NOT (tagl < tag2) 
tagl < tag2 is true and would return a 1 but the NOT operator reverses the 
logical value so 0 is returned 


Important: the parentheses are essential in above expressions. 


Bitwise Operators Bitwise operators allow you to examine and manipulate individual bits 
within a value. These operators can only be applied to integers, not floating 
point numbers. 


Table 3.D 
The Bitwise Operators 


AND 


tag1 & 07 


| inclusive OR tag2 | tag1 
A exclusive OR (XOR) tag1 ^01 
«« left shift tagi << 2 


complement ~ tagi 
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The bitwise operators &, |, and ^ compare two integers or tags on a bit by 
bit basis. The >>, <<, and ~ operators manipulate a single integer or tag. 


The bitwise AND ( & ) returns an integer with its bits set to 1 if both of 
the corresponding bits in the original numbers are 1. Otherwise, the 
resulting bit is 0. 


The bitwise inclusive OR (|) returns an integer with its bits set to 1 if 
either or both of the corresponding bits in the original numbers are 1. If 
both bits are O, the resulting bit is 0. 


The bitwise exclusive OR (^) returns an integer with a bit set to 1 if either 
of the corresponding bits in the original numbers is 1. If both bits are 1 or 
both are 0, the resulting bit is 0. 


The bitwise operators &, |, and “ are illustrated below: 


Figure 3.1 
The &, |, and ^ Bitwise Operators 


bit in first operand 

bit in second operand 
result of & operation 
result of | operation 
result of ^ operation 
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The shift right operator ( >> ) shifts the bits within the left operand by 
the amount specified in the right operand. The bit on the right disappears. 


Figure 3.2 shows the result of the expression 114 >> 1 = 57. 


Figure 3.2 
The Shift Right Operator 


[ol if fr [of of io] «n 


zero shifted in -— \ \ \ bit disappears 


ofofifififofo[1] = 


Either a O or a 1 is shifted in on the left, depending on whether the integer 
is signed or unsigned. With unsigned integers, 0 is always shifted in on the 
left; with signed integers, a 0 is shifted in when the number is positive (i.e. 
the leftmost bit, the sign bit, is 0), and a 1 is shifted in when the number is 
negative (i.e. the leftmost bit, the sign bit, is one). In other words, with 
signed integers, the sign of the number is always maintained. 


40239 
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Built-in Functions 
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The shift left operator ( << ) shifts the bits within the left operand by the 
amount specified in the right operand. The bit on the left disappears and a 
0 is always shifted in on the right. 


The bitwise complement operator ( ~ ) reverses every bit within the 
number, so that every 1 bit becomes a 0 and vice versa. 


Examples: Bitwise Operators 
For these examples tag] = 5 (binary 0101), tag2 = 3 (binary 0011) 


tagl & tag2 
returns 1 (binary 0001) 


tagl | tag2 
returns 7 (binary 0111) 


tagl ^ tag2 
returns 6 (binary 0110) 


tagl >> 1 
returns 2 (binary 0010) 


tagl << 1 
returns 10 (binary 1010) 


~ tagl 
returns 10 (binary 1010) 


The built-in functions return floating point values. 


Many of the functions check for specific true/false conditions. Such 
functions return 1 if the condition is true, and 0 if the condition is false. For 
instance, the COMM ERR) function returns 1 if the specified tag has a 
communication error. 
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Table 3.E 
Built-in Functions 


This function: Returns this value: 


SQRT(tag) 


the square root of the tag (or of a 
constant) 


COMM ERR(tag) TRUE if a read or write operation 
for the specified tag produced a 


communication failure 


TRUE if the tag's alarms are 
suppressed 


TRUE if there has been an alarm 
fault for the specified tag 


ALM SUPPRESS(tag) 
ALM FAULT(tag) 


ALM SEVERITY (tag) the severity of the alarm — a value 
between 1 and 8, or O if the tag isn't 


in alarm 


ALM LEVEL(tag) the alarm level for the tag — a value 
between 1 and 8, or O if the tag isn't 


in alarm 


TRUE if the tag's alarm has been 
acknowledged 


TRUE if the tag is in alarm 


ALM. ACK(tag) 


ALM, IN ALARM(tag) 


Important: The alarm (ALM) functions will only be relevant if the 
Alarming option is installed. 


T —————————————————————————————————————— 


Examples: Tag Functions 


ALM IN ALARM(vessel3.TIC3.pv) 
returns 1 if the tag is in alarm or 0 if it isn't 


SORT (vessel3.TIC2.pv) 
returns the square root of the tag value 


SQRT (25) 
returns a value of 5 
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Operator Precedence There are three rules used to determine the order for evaluating an 
expression that has more than one operator. 


1. When two operators have unequal precedence, the operator with the 
highest precedence is evaluated first. 


2. When two operators have equal precedence, they are evaluated from 
left to right. 


3. To change the normal order of precedence, enclose the statement in 
parentheses. 


Here are the operators from highest to lowest precedence: 


Table 3.F 
Operator Precedence 


Precedent Level 
1 (highest) 


Logical negation 
Bitwise complement 


multiplication 
division 
modulus (remainder) 
exponent 

logical and 

bitwise and 

bitwise shift right 
bitwise shift left 


addition 
subtraction 

logical or 

bitwise inclusive or 
bitwise exclusive or 
the built-in functions 
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Examples: Operator Precedence 

For these examples, tag] = 5, tag2 = 7 and tag3 =10. 
(tagl > tag2) AND (tagl < tag 3) 
is evaluated in this sequence: 

1. tagl >tag2=0 

2. tagl«tag3-1 

3. OAND1=0 

The expression evaluates to 0. 

tagl>tag2 AND tag3 

is evaluated in this sequence: 

1. tag? AND tag3 = 1 

2 tagl>l=1 

3. The expression evaluates to 1. 

NOT tagl AND tag2 > tag3 ** 2 

is evaluated in this sequence: 

1. NOT tagl =0 

2. OANDtag2=0 

3. tag3 **2=100 

4. 0>100=0 


The expression evaluates to 0. 
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IF-THEN-ELSE The IF-THEN-ELSE structure allows an expression to make a decision. 
The format of the IF-THEN-ELSE structure is: 
IF statement THEN valuel ELSE value2 


If the statement is true then the expression will return value; if the 
statement is false then the expression returns value2. Keep in mind that the 
statement is a mathematical equation and that true means a non-zero value, 
and false means zero. 


The IF-THEN-ELSE structure is illustrated below. 


Figure 3.3 
The IF-THEN-ELSE structure 


enter 


| true 


, 


false 


()- 
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Nested IF-THEN-ELSE structure 


It is common to nest an entire IF-THEN-ELSE structure inside another 
IF-THEN-ELSE structure. 


When nesting IF-THEN-ELSE structures, it is important to remember that 
an ELSE is associated with the last IF that doesn’t have its own ELSE. 


Example 1: Nested IF-THEN-ELSE 


This expression: 

IF (statement1) THEN (valuel) 

ELSE IF (statement2) THEN (value2) 
ELSE (value3) 


has this interpretation: 


Figure 3.4 
Nested IF-THEN-ELSE 


true 
statement 


| false 


true y 

value1 
false 

— To 
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Example 2: Nested IF-THEN-ELSE 

This expression: 

IF (statementi) THEN 
IF (statement2) THEN (valuel) 
ELSE (value2) 

ELSE (value3) 

has this interpretation: 


Figure 3.5 
Nested IF-THEN-ELSE 


tr true 
inei] P e Ge e [in | 


i false | false 
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Comments 


Expression Formatting 
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Comments begin with an exclamation point. All text following the 
exclamation point, to the end of the line, is not evaluated. 


Example: Comments in a ControlView Expression 
In a single line such as: 
IF a>b THEN c ELSE d ! if/then expression 
only that part preceding the exclamation point is evaluated. 
In several lines such as: 
IF a»b ! temp a greater that temp b 

THEN c ! shut valve 


ELSE d ! do nothing 


only those parts preceding the exclamation points in each line are 
evaluated. 


The Data Logger editor ignores tabs, new line characters, and multiple 
spaces, so a large expression can be condensed to make maximum use of 
the editor space. 


ee pay UU P IE Ee — 
Example: Expression Formatting 
The following expression: 
If (tagl > tag2) then 0 
else if (tagl > tag 3) then 2 
else 4 


Could be condensed to the following: 


If (tagl > tag2) then 0 else if (tagl > tag3) then 
2 else 4 
E SAO A A A 


Important: Do not allow tag names, function names or function 
arguments to span more than one line. 


Start/Stop Menu 
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Running the Data Logger 


This chapter describes how a Data Logger model is loaded so that database 
values can be logged. 


Data Logger reads through the entire tag list of each model, logging each 
tag that does not have an expression and each tag with an expression that 
evaluates to TRUE. It then waits for a specified time — the Sample Rate 
defined for the model — before repeating the process. 


The Data Logger manages all models concurrently. It does not wait for one 
model to finish scanning before it starts scanning the tag list of the next 
model. 


The Data Logger can be controlled interactively with the DL 
Runtime-Model List Browser. It can also be run from the Start/Stop menu, 
or from the command line with the DATALOGON and DATALOGOFF 
commands (for more information on the commands, see Appendix A, Data 
Logger Commands). 


To begin or end logging data for Data Logger models, choose items in the 
Start/Stop menu. 


Figure 4.1 
The Start/Stop Menu 


Actions Menu 


Start Alarms 


View | Tags | Security | Tools | Setup | Exit | 
Stop Alarms 


Start Alarm Handshake 
Stop Alarm Handshake 


Start Derived Tags 
Stop Derived Tags 
Start Event Detector 
Stop Event Detector 


Start Activity Logging 
Stop Activity Loggin 


Stop Data Logs 
SAMPLE1 | 
Stop All Data L SAMPLE2 
42263 


4-1 


Chapter 4 


Running the Data Logger 


DL Runtime-Model Browser 


4-2 


Start Data Logging 


If you choose Start Data Logging, a list of the models in your system will 
be displayed. Highlight the model you wish to log and press Enter to 
begin periodic logging. The appropriate database must already be loaded 
before you can load a Data Logger model. 


Important: Only one task at a time can write data to a model. If a 
C-Toolkit task is writing data when you choose Start Data Logging, the 
command will fail. 


Important: When you start periodic logging, ControlView puts the 
requested tags on scan and immediately takes the first snapshot. It is 
possible that this first snapshot will be taken before all the tags have 
scanned. This will be apparent in the log file since the on-scan status bit 
will be zero. 


Stop Data Logging 


To stop logging one model while leaving other models still logging, choose 
Stop Data Logging. A list of models will be displayed. Highlight the one 
you wish to stop and press Enter. 


Stop All Data Logging 


Choosing this action will stop logging all models at once. 


If you wish to run Data Logger interactively, go to View in the Actions 
menu and choose Get Data Logger Info to open the Model List Browser 
illustrated in Figure 4.2. You may also call up the Model List Browser by 
typing DATALOGON in the command line with no model specified. 


The Model List Browser duplicates the actions provided in the Stop/Start 
menu and and also offers additional information. 
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Figure 4.2 
The DL Runtime-Model List Browser 


DL Runtime-Model List Browser 


Show Active 


Show Active / Show All 


This option will list only those models that are running. When you choose 
Show Active, the first menu option changes to Show All and the Start menu 
option disappears. 


Status 


Select a model and choose Status. The following window appears: 


Figure 4.3 
Status of Data Logger Model 


Status of DataLogger Model 


Model Name: 


Description: | 
Status: | o Started Logging: 
Sample Rate: (seconds) Snapshot Only: Number of Tags: 
# of Files: KBytes per fle — Xil 


% size 


o “Cancel <Esc>) 
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This window shows the model’s definition, the time and date it was loaded, 
and whether or not it is active. The % Full indicator specifies the space 
taken up by the logged data for this model in its group of log files. The 

% Size shows the maximum size of a snapshot as a percentage of the 
maximum allowable space (4,000 bytes of data). 


Start 


To start logging, select a model and choose Start. The model starts up and 
the word "Active" is displayed beside the model name. The appropriate 
database must be loaded before you load a Data Logger model. 


Important: Only one task at a time can write data to a model. If a 
C-Toolkit task is writing data when you choose Start, the command will 
fail. 


Important: When you start periodic logging, ControlView puts the 
requested tags on scan and immediately takes the first snapshot. It is 
possible that this first snapshot will be taken before all the tags have 
scanned. This will be apparent in the log file since the on-scan status bit 
will be zero. 


Stop 


To stop logging, select an active model and choose Stop. The model stops 
and the word “Active” is removed from the model name. 


Find 
Rather than using the arrow keys to move through the list of models, use 


the Find option to select a model. Choose Find from the menu and type in 
the model name. 


Stop All 


To stop logging all active models, choose Stop All. 


Snapshot 


To take a snapshot of a particular Data Logger model, highlight the model 
and choose Snapshot, then confirm the request. You can also use the 
DATALOGSNAPSHOT command to take a snapshot (see Appendix A 
Data Logger Commands for details). 
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The appropriate database must be loaded before you can take a snapshot of 
a Data Logger model. 


Important: Only one task at a time can write data to a model. If a 
C-Toolkit task is writing data when you choose Snapshot, the command 
will fail. 


Snapshots and Active Models 


The amount of time required to take a snapshot depends on whether the 
model is active (i.e., has been started). 


If the model is active, Data Logger will quickly check that all necessary 
tags are on scan and record their value in the log file. 


If, in contrast, the model is not active, Data Logger must go through all the 
steps required to start up a model (i.e., verify the model against the 
database to make sure the model is valid, open the log files, and put the 
tags on scan). Only then will it check that the tags are on scan and record 
their value in the log file. When finished, Data Logger must then go 
through all the steps required to stop a model (i.e., close the log files and 
take the tags off scan). 


Obviously, less time is required to take a snapshot of a model that is active. 
If you require fast response or are going to be taking many snapshots of a 
model, as in an event-driven model, you should start the model before you 
begin taking snapshots. However, if you will just be taking one-time 
snapshots, then there is no advantage to starting the model first. 


DATALOG 
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DATALOG [model] [/n] 
Calls up the Data Logger editor. 


model the name of the model to be created or edited. If no 
model is specified, DATALOG opens the DL Edit - 
Model List Browser for you to create, edit, and delete 
models and their associated tag lists. 


In turns autoverification off. This parameter allows you to 
edit, without autoverification, if your setup has turned 
autoverification on. 


Remember, when autoverification is on, a database must 
be loaded in memory and all the tags in the list must 
already exist in the database. 


Examples: DATALOG command 
DATALOG sample 


Loads the DL Editor - Tag List Browser screen for you to change or add to 
the tag list of the sample model. 


DATALOG sample /n 


This command also loads the DL Editor - Tag List Browser screen for you 
to change or add to the tag list for the sample model. However, unless you 
are using the [/n] parameter, a database must be loaded so the Data Logger 
Editor can check each tag in the list against the database. 


DATALOG 


Loads the DL Editor - Model List Browser. 
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DATALOGEXPORT 
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DATALOGEXPORT [options] 


The DATALOGEXPORT command converts logged files to a compressed 
ASCII format for viewing, and for use with popular database packages. 
The [options] are: 


/Mmodel where model is the name of the Data Logger model to be 
exported 

/Ttemplate where template is the name of the export template 

/Foutfile where outfile is the name of the file to be created or 


updated by the export procedure 
JO overwrite an existing output file 
IA append to an existing output file 


IX bypass the Export Browser and start exporting the 
specified model or template 


/En export format, where: 
n=1 linear format with status bits 
n=2 linear format without status bits 
n=3 columnar 
These formats are explained in Appendix B, Exporting 
Data Logger Files. 


IS exports silently, suppressing the “Export Complete” 
message 


If you are executing DATALOGEXPORT from the command line and at 
the same time are using the menu system, make sure to use the /X 
command line parameter to force the Data Logger export utility to operate 
in the background. 


Example: the DATALOGEXPORT Command 


DATALOGEXPORT /Msample /Flogdata /X 
will export all logged data for “sample” into file “logdata” without opening 
the Export Browser. 


DATALOGOFF 


DATALOGON 
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DATALOGOFF [model] [/A] 

model the name of the model you want to stop logging 

IA stops the logging of all Data Logger models. 
Important: You can’t specify both the [model] and the [/A] parameters. 


If no parameter is specified, the DATALOGOFF command calls up the DL 
Runtime - Model List Browser where you can start, stop and find models 
and view their status as well. 


Examples: DATALOGOFF command 


DATALOGOFF sample 
Stops logging the model called sample. 


DATALOGOFF /A 
Stops logging all Data Logger models. 


DATALOGOFF 
Loads the DL Runtime - Model List Browser. You can stop or start one or 
more models from this screen. 


DATALOGON [model] [/S] 


Begins logging the specified model. If no model is specified, the 
DATALOGON command calls up the DL Runtime - Model List Browser 
where you can start and stop models and view their status. 


model the name of the model to be logged 
IS starts logging silently, suppressing the verification 
message 


Important: Only one task at a time can write data to a model. If a 
C-Toolkit task is writing data when you enter the DATALOGON 
command, the command will fail. 


Important: When you start periodic logging, ControlView puts the 
requested tags on scan and immediately takes the first snapshot. It is 
possible that this first snapshot will be taken before all the tags have 
scanned. This will be apparent in the log file since the on-scan status bit 
will be zero. 
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DATALOGSNAPSHOT 
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Examples: DATALOGON command 

DATALOGON sample /S 

Starts logging the sample model and suppresses the verification message. 
DATALOGON 


Loads the DL Runtime - Model List Browser which allows you to start, 
stop or find models, or view their status. 


DATALOGSNAPSHOT [model] [/S] 
Logs the values in the specified model. 


model the name of the model used for the snapshot. If no model 
is specified, the DATALOGSNAPSHOT command calls 
up the DL Runtime - Model List Browser. 


IS suppresses the verification message 


Important: The appropriate database must be loaded before you take a 
snapshot of a Data Logger model. 


Snapshots and Active Models 


The amount of time required to take a snapshot depends on whether the 
model is active (i.e., has been started). 


If the model is active, Data Logger will quickly check that all necessary 
tags are on scan and record their value in the log file. 


If, in contrast, the model is not active, Data Logger must go through all the 
steps required to start up a model (i.e., verify the model against the 
database to make sure the model is valid, open the log files, and put the 
tags on scan). Only then will it check that the tags are on scan and record 
their value in the log file. When finished, Data Logger must then go 


through all the steps required to stop a model (i.e., close the log files and 
take the tags off scan). 
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Obviously, less time is required to take a snapshot of a model that is active. 
If you require fast response or are going to be taking many snapshots of a 
model, as in an event-driven model, you should start the model before you 
begin taking snapshots. However, if you will just be taking one-time 
snapshots, then there is no advantage to starting the model first. 


Example: Using DATALOGSNAPSHOT with the Event Detector 
To create an event-driven data logger model, you would: 


1. Define a Data Logger model and specify Yes in the Snapshot Only 
field. 


2. Create an event file with at least one event. For that event, specify the 
expression that will trigger the snapshot in the Expression field and 
add the DATALOGSNAPSHOT command to the Action field. (See the 
Event Detector User Manual for details.) 


3. Load the appropriate database. 
4. Start the Data Logger model. 
5. Start the Event Detector. 


Since you specified Yes in the Snapshot Only field when you defined the 
model, no data is logged when you start the model. However the model is 
active when the Event Detector runs the DATALOGSNAPSHOT 
command, so the data will be logged quickly. 


Example: Using DATALOGSNAPSHOT with Alarming 


When defining alarms for a tag, you can specify a command that an 
operator can execute (using the IDENTIFY command) when the tag goes 
into alarm. DATALOGSNAPSHOT would be a good candidate for this 
command. 


In this scenario, there would be no need to specify Yes in the Snapshot 
Only field or to start logging the model in advance since this is a one-time 
snapshot. 
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DLEXPORT DLEXPORT — A DOS Command 


In addition to DATALOGEXPORT, a DOS stand alone program called 
DLEXPORT also exports data. It is in the \ACCESS\UTIL directory. 


Parameters are specified identically for DLEXPORT and 
DATALOGEXPORT, including: [/M],[/T],/F],[/A],[/O], [En], [/S] and 
[/X]. The two exception are that DLEXPORT takes additional parameters 
to specify the disk drive and base directory of the Data Logger files (the 
/Dbase_dir parameter), and to specify an alternative format for the date 
(the /Yformat_string parameter). 


/D points to the drive and directory of the Data Logger 
files. In the default system, this directory is 
C:\ACCESS\DL (or whichever drive Control View is 
located on); however, Control View can be configured to 
store Data Logger files in a different directory or drive. 


há specifies the date format. The format string uses these 
symbols: 


Soda Bampi 


%1 Local date representation based on DOS | 12/25/92 for Country Code 001 i 
Country setting (United States) U 


%n 3 letter abbreviated month name Jan 


a a 
a fro E 


%Y year including century 1992 


Important: Separate parts of the date with slashes or dashes; don t use spaces. 


Example: Sample Date Formats 


This format string produces this date format 
%y/%m/%d 92/12/2(The default format.) 
%d-%N-%y 25-January-92 

%1 12/25/92 for Country Code 001 


25.01.1992 for Country Code 049 
etc. See your DOS manual for details. 


%1/%d/%y 12/25/92 
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DLEXPORT can export all data logged for a model, or data previously 
specified on an export template. Export templates can only be created and 
modified using Control View’s DATALOGEXPORT command. 


See Appendix B, Exporting Data Logger Files, for complete details 
(including file format and examples) on exporting Data Logger files. 
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Exporting Data Logger Files 


Log files are created in a compressed format, so to use the data with other 
software packages, they must be converted to ASCII. To convert the 
logged data to this generic format, you will have to export it. Data Logger 
can export specific tags and times with an export template, or it can export 
all logged data for a model as well as previously archived files. 


Important: Templates created with Data Logger 1.0 are not compatible 
with Data Logger 2.0 or later software because of the addition of the Date 
Format specification. If you try to Modify an incompatible template, or to 
view its Tag List, the system will offer to convert the template to the new 
format. If confirmed, the old template will be converted automatically. 


Begin the exporting process by choosing Export Data Logger Data under 
Tools in the Actions Menu. 


Figure B.1 
Choose Export Data Logger Data 


Actions Menu £ 


Load | Start/Stop | View | Tags | Security 


Print File 
List File 
List ActivityLog — 
Capture Network Printer | 
Archive files 
Restore files 
Enter a Remark. 


Export Data Logger Data 
Communication Status 
A-B Highway Diagnostics 


The DL Model List Browser will appear. This screen and its associated 


screens allow you to execute the various actions involved in the export 
process. 
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Figure B.2 
DL Export Model List Browser 


DL Export Model List Browser Editor i ee 


List Export Templates Find Model port All | Date Formats 


DataLogger Model Directory: CNACCESSNDL 
Current Database: SAMPLE 


Description 
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List Export Templates 


Choose List Export Templates to open the DL Export Template List 
Browser where templates are exported, modified, duplicated, created, 
deleted and located. Export templates are use only when a specific set of 
tags or a specific time range are to be exported. 


Since each Data Logger model can have its own set of export templates, 
highlight a specific model before choosing List Export Templates. 


Details on creating and modifying templates are described later in this 
chapter. 


Find Model 


Choose Find Model to quickly locate a model without having to scroll 

through the entire model list. When you choose Find Model, a window 
opens for you to type in the model name. Type the first few identifying 
letters and press Enter to locate the model of your choice. 


Figure B.3 
Find Data Logger Model 


Model Name: REGUM 
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Export All 


Choose Export All to export all the data for the model highlighted in the 
Export Model List Browser. Templates need not be created for you to 
export logged data in a model. They are only required to export a specific 
subset of tags and a range of times and dates. 


Figure B.4 
Export All Data 


port All Data to File Name fã 


Model Name: 


Output File Name: 


Append to File: Export Mode: h 
- Export Format: i 


Accept <+>] Cancel Esc>] 
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Output File Name 


Assign a file name to the model you are exporting. Use this field to enter 
the name of the disk drive, directory, file name and optional extension. 


Append to File 


If an export file has been previously created, this field allows you to add 
the new or modified information to it. Choose YES to append to the file or 
NO to have the file overwritten. 


Export Mode 

There are three export modes: 

* Foreground — displays a window that remains on the screen 
throughout the export operation. This window has a Cancel button 
allowing you to abort the export at any time. 

= Background and Notify — exports the file in the background and 
displays a message when complete. Once begun, the export operation 
can not be aborted. 

= Background Silently — exports the file in the background. No 


messages, except error messages, are displayed once the export is 
underway. Once begun, the export operation can not be aborted. 
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Export Format 


There are three export formats: 


a Linear with status bits — every snapshot will consist of a series of lines, 
with one line per tag. Each line will have the time and date, tag name, eight 
bits (1’s and O's) representing the tag's status, and the tag’s value. 


» Linear without status bits — the same as Linear with status bits, 
except the status bits are not exported. In other words, each line will 
contain a time, date, tag name and value. 


=a Columnar — each snapshot will contain one line showing the date and time 
and all tag values for that snapshot. Any tag whose value was not recorded 
for the snapshot will be represented by a blank (surrounded by commas) in 
the list of values. 


The three file formats are explained more fully later in this chapter. 


Important: Tag values will be exported for Columnar or Linear without 

status bits modes only if the tags had no communication errors and were 

on scan. If the log file has the Com-Error bit set to one, or the On-Scan bit 

set to zero, the tag value will not be exported. O 


Date Formats 


Choose Date Formats to specify the way dates will be formatted in the 
exported files. You can define four ways to format dates. The default 
format is YY/MM/DD. Later, in the DataLogger Export Template screen 
(Figure B.14), you select which format you want to use to match the 
software package that will use the exported data. 


Table B.A 
Codes used to Define Date Formats 


Symbol Ban 


%1 12/25/92 for Country Code 001 
Country setting (United States) 

%n 3 letter abbreviated month name Jan 

E mm E 

m mm f 

" ronen f 

w Ez 


Important: Separate parts of the date with slashes or dashes; don’t use spaces O 
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Example: Sample Date Formats 


This format string produces this date format 
%y/%m/%d 92/12/2(The default format.) 
%d-%N-%y 25-January-92 

%1 12/25/92 for Country Code 001 


25.01.1992 for Country Code 049 
etc. See your DOS manual for details. 


%1/%d/%y 12/25/92 


Figure B.5 
Date Formats 


Default Format: “%y/%m/%d appears as 90/04/25 
Date Format 1: May-11-90 
Date Format 2: May 11, 1990 


Date Format 3: 11-May-90 


Date Format 4: 
Symbols: 


Local date representation based on DOS COUNTRY setting 
abbreviated month name 

full month name 

day of month 

month 

year without century 

year with century 


a 
A 
"on won uum 


Test ] Accept <+>] Cancel <Esc>] 
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Examples of date formats are displayed when you click on the Test button. 


Templates are created to export specified tags from any given model, along 
with a range of dates and times. Templates are created, modified and run 
through the Export Template List Browser and the screens that open from it. 


To open the Export Template List Browser, highlight a model and choose 
List Export Templates from the DL Export Model List Browser. 
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Figure B.6 
DL Export Templates List Browser 


DL Export Template List Browser 


Export Modify Tag List | Duplicate | Create | Delete | Find 


Data Logger Model Directory: C:\ACCESS\DL 
Model: SAMPLE 


42075 


This screen can perform the following functions. 


Export 


Highlight a model and choose Export to export data. There are three 
different export modes; choose the desired mode from the pop-down menu. 


The three export modes are: 


a Export in Foreground — displays a window that remains on the screen 
throughout the export operation. This window has a Cancel button 
allowing you to abort the export at any time. 


= Export in Background and Notify — exports the file in the 
background and displays a message when complete. Once begun, the 
export operation can not be aborted. 


= Export in Background silently — exports the file in the background. 
No messages, except error messages, are displayed once the export is 
underway. Once begun, the export operation can not be aborted. 


Modify 


To modify a template, choose this option to open the Data Logger Export 
Template screen. Details and illustrations on how to create and modify 
templates are covered a little later in this chapter. 
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Tag List 


This menu option opens the DL Export Tag List Browser where all tags are 
listed whether exported or not. See the Tag List section immediately 
following this section, for details on the function and management of this 
option. 


Duplicate 


To create a copy of your template without having to recreate or modify an 
existing one, open this menu option and enter a new name for either the 
template, the model, or both. When you enter a new model name, the 
duplicate feature copies the export template to that model. 


Figure B.7 
Make Duplicate Export Template 


um 
| Make Duplicate Export Template 


. Old Template: SAMPLE Enter NEW Template Name: KE 
Old Model: SALAD Enter a NEW Model Name:[SALAD ] 
Accept <+> |. Cancel Esc>] o 


42203 


Create 


To create a new template, use this option to open the Data Logger Export 
Template. See details on how to create and modify templates later in this 
chapter. 


Delete 


This option allows you to delete a template. Choose Delete and a window 
will open asking you if you want to delete this template. 
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Figure B.8 
Delete DL Export Templates 


Delete DL Export Template 


Warning: This instance of SAMPLE about to be deleted! 
Are you sure that you wish to delete this 
Export Template? 


42204 


Find 


To find an export template quickly without scrolling through the entire list, 
choose Find. Type the name or the first few identifying letters of the 
template you wish to locate in the file and press Enter. 


Tag List The Tag List is a menu option accessed through the DL Export Template 
List Browser. When you choose Tag List, the DL Export Tag List Browser 
opens. This screen and its associated menus allow you to both manage and 
view all tags, whether exported or not. 


Figure B.9 
DL Export Tag List Browser 


à DL Export Tag List Browser 


Show Export 


Model Name: SALAD 
Template Name: DINE Number of tags exported: 1 


VIN.LEVEL Bulk vinegar tank level 
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Displayed below the menu options available in the Export Tag Browser, 
are the names of the model and template. The number of tags that are 
marked for export is also displayed. Within this screen, menus allow you to 
manage export tags in the following ways. 
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Show Export 
Choosing this option opens the DL Exported Tag List Browser where only 
exported tags are listed. 


Figure B.10 
DL Exported Tag List Browser 


DL Exported Tag List Browser 


Model Name: 
Template Name: 


É Number of tags exported: 
Tonara — 
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Within this screen you may delete or find tags that have already been 
included in this export template. 


Show All 


This menu, when chosen, will return you to the DL Export Tag List 
Browser, Figure B.9. 


Delete Tag, Find Tag 

The delete and find menu options in the Exported Tag List Browser are 
identical to those found in the Export Tag List Browser (Figure B.9), and 
are used for the same purpose. 


Add Tag 


Choose this option to add a tag to the export template list. A window 
appears with the name of the tag highlighted in the Tag List Browser. 
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Figure B.11 
Add Tags to Data Logger Export Template 


Add Tag to DataLogger Export Template 


Tag Name: VIN.LEVEL 


Condition: 


Accept <+>] Cancel Esc> 


42079 


Delete Tag 


To remove a tag from an export template, choose Delete Tag. A window 
appears with the name of the tag highlighted in the Exported Tag List 
Browser. 


Figure B.12 
Delete Tags from Export Template 


elete Tag from Export Template 


Tag Name: VIN.LEVEL 


Condition: 


Accept <+> } Cancel Esc>] 
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Find Tag 


To find an exported tag quickly, choose Find Tags and type the first few 
identifying letters of the tag name in the field provided. Press the + key to 
complete the task or Esc to stop the request. 


Figure B.13 
Find Tags in Data Logger Model 


Find Tag in Datalog Model 


Tag Name: E 
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Creating and Modifying 
Templates 
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To create a template, choose Create in the DL Export Template List 
Browser. This action will open the Data Logger Export Template screen. 


Figure B.14 
Data Logger Export Template 


DataLogger Export Template 


DataLogger Model Directory: \ACCESS\DL 
Model: MODEL1 


Export Template Name: [ ] Export Date Format: [__] 
Template Description:[ 7} 


Output Filename: | 
Export Format: 
Append to File: Incremental Export: = 
dar pa SS 
Stop Time and Date: 


Tag List: Co] 


Action: 
G LRL TES CELER a pe | 
# of tags to be Exported: Last Exported: 


Accept <+>] Cancel <Esc> 
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This screen and the one opened through the Modify menu are identical. 
However, new templates must first be created here. To change an existing 
template, open the Modify menu. Both screens contain the following 
fields. 


= Export Template Name 


Name the template, by entering a name with up to eight characters in the 
field provided. 


= Export Date Format 


Pressing Enter with the cursor in this field will produce this valid entry 
list: 


Default 
Datel 
Date2 
Date3 
Date4 


42570 
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The default format is YY/MM/DD; (July 30, 1990 is represented in this 
format as 90/07/30). The other four formats must have been defined 
previously in the Date Formats screen. Select the format most appropriate 
for the software you intend to use with the exported data. 

a Template Description 

Use this field to enter an identifying description for the template. 

= Output Filename 


Give an output filename to the ASCII file you are creating and include the 
name of the disk drive, directory, file and (optional) extension. 


= Append to File 


You can append information to an existing export file by specifying YES in 
the Append to File field. Specify NO if you want the exported data to 
overwrite any data that may exist in the file. 


= Incremental Export 


When you specify YES in the Incremental Export field, only the data 
logged by this model after the last export with this template will be 
exported in future. 


Example: Incremental Export 


Assume that the model has logged data for Monday through Wednesday 
and data is exported for the first time on Wednesday. The export file will 
contain all data for Monday through Wednesday. 


If data logging is resumed for Thursday and Friday and the data is exported 
again on Friday, the Incremental Export setting determines how much data 
is exported. 


With Incremental Export set to YES, only Thursday and Friday’s data will 
be exported. If Incremental Export were set to NO, all data for Monday 
through Friday would be exported. 


Keep in mind that the Append to File setting will determine whether the 
new data will overwrite existing data in the file or be appended to it. 


» Start Time and Date, Stop Time and Date 


Start and Stop times can be defined as absolute or relative. 
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Absolute times must contain the month, day, and year; they can include the 
hour and minutes. If the time is omitted, 00:00 is assumed. The format for 
an absolute time is: 


MMM DD YYYY hh:mm 


MMM is the abbreviation for the month 
DD is the date 
YYYY is the year 
hh:mm is the time 


Example: Absolute Start and Stop Times 


You could specify that exporting start on 
Oct 19 1989 13:20 

and that it stop on 

Oct 30 1989 13:20 


Once data is exported for that period, dates and times must be reset or the 
system will stop exporting. To avoid having to reset the stop and start times 
and dates, you can use a relative time description. 


Relative time settings are defined with the words NOW or TODAY, along 
with the number of hours, minutes or seconds of the total exporting time. 
To use this format accurately, break the time description down to its 
smallest units. Thus, one hour and ten minutes, would be entered as 70 
minutes. 


Bearing in mind that data must be logged before it can be exported, the 
NOW specification will always be followed by a minus sign and the 
number of hours, minutes or seconds involved. 


Example: Relative Start and Stop Time 


Suppose that you want to export all data that was logged between 8:00 am 
and 12:00 am and it is now 2:00 pm in the afternoon. Your start time would 
read NOW - 6 hours and your stop time would read NOW - 2 hours. 


Using TODAY as part of your time configuration orients the start or stop 
time to 00:00 hours of the day. Therefore, if you were exporting data 
between the hours of 10:00 pm yesterday and 4:00 am today, the start time 
would read TODAY — 2 hours and the stop time TODAY 4 4 hours. 
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Relative time descriptions allow you to set exporting times once, so they 
don’t have to be continually updated. However, be consistent in whatever 
format you do decide to use. 


Ensure that both start and stop times are expressed either as relative or as 
absolute. The two formats are not designed to be used in combination. 


= Tag List 

This list allows you to export selected tags from the model, or all tags from 
the model. Press Enter to see a pop-up box with these two choices and 
select one by pressing Enter. 

= Action 

You may specify a command or macro in this field, and the command or 
macro will run when the export operation is complete. You can leave this 
field blank. 

= ft of Tags (Number of Tags) 


This number is calculated by the system and displayed so you can know at 
a glance how many tags are being exported. 


= Last Export 


Again, this is calculated by the system and displayed to indicate when the 
last export occurred. 


When you have filled all the fields in this screen, press the + key to 
complete the task. 


File Format Exporting a Data Logger file produces an ASCII file. There are three 
different file formats: 


» Linear with status bits 

» Linear without status bits 

a Columnar 

Important: A non-printable character in a string tag will be replaced with 


an asterisk in the exported file, regardless of which format you use. 
Trailing null characters will be truncated. 
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Field 
Year 


Time 
Tag name 
Current val 
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Linear with status bits 


Each record in the exported Data Logger file contains the information for 
one tag each for one snapshot. The length of this record will vary 

depending on the type of tag: a string tag, for example, could need up to 82 
bytes to store the data. The fields are as follows: 


Table B.B 
Linear with status bits Export File Format 


[tena «(Format Description 

ee on format: default | Configurable: Default is numerical year, month, day, separated by "”, followed by a blank. Four 

is 9 default is other formats can be configured to make exported files compatible with other 
YY/MM/DD software. 

O [mmm | Numerical hour, minute, second, separated by ”.”, followed by two blanks. 

m sing [Tagname,leftjustied, followed by two blanks. 


for numeric: 21 varies according to | Value of tag, in appropriate format. This could be an integer, a floating point 
tag type number, exponential notation, or a string as the value requires. 


tag plus three For analog values, there are at most six digits to the right of the decimal point. 
The value is given in twelve columns, followed by six blanks. 


for string: length defined for 


Com error PO Rs Communications error status. Value is 1 if in error, O otherwise, followed by one 
blank. 


On_scan 
Alm_supp 


Alm_fault 
Alm_bit 


Le Tag on scan status. Value is 1 if on scan, 0 otherwise, followed by one blank. 


Alarm suppression status. Value is 1 if alarms for this tag are suppressed, 0 
otherwise, followed by one blank. 
2 [B | Alarm fault status. Value is 1 if alarm faulted, O otherwise followed by one blank. 
2 Le Alarm bit status. Value is 1 if tag in alarm, 0 otherwise, followed by one blank. 


Alm severe ——— Alarm severity. Value is between 0 and 8, followed by one blank. 


Alm level 
Alm, ack 


Alarm level. Value is between 0 and 8, followed by one blank. 


Alarm acknowledge status. Value is 1 if alarm is acknowledged, 0 otherwise, 
followed by three blanks 
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Field 
Year 


Time 
Tag name 
Current val 


Linear without status bits 


Each record in the exported Data Logger file contains the information for 
one tag each for one snapshot. The length of this record will vary 
depending on the type of tag: a string tag, for example, could need up to 82 
bytes to store the data. The fields are as follows: 


The fields are as follows: 


Table B.C 
Linear without status bits Export File Format 


Leng CE E 


depends on format: default | Configurable: Default is numerical year, month, day, separated by "/", followed by a blank. Four 

is 9 default is other formats can be configured to make exported files compatible with other 
YY/MM/DD software. 

|o 0 [mmms | Numerical hour, minute, second, separated by ”.”, followed by two blanks. 

22s string — OE) Tag name, left justified, followed by two blanks. 


for numeric: 21 varies according to | Value of tag, in appropriate format. This could be an integer, a floating point 

for string: length defined for tag type number, exponential notation, or a string as the value requires. 

tag plus three For analog values, there are at most six digits to the right of the decimal point. 
The value is given in twelve columns, followed by six blanks. 


Columnar 


In columnar format, each record in the exported file contains all the tag 
values recorded in one snapshot. 


The record contains the date and time, followed by a series of values, 
separated by commas. If any values were not logged (or if there were any 
communication errors for the tag) the value will be omitted, and its place 
will be represented by the comma placeholders. 


The record's length is determined by the number of tags in a model, and 
the type of data recorded. 
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Example: Sample Export File 


The following example shows the three different formats of an exported 
Data Logger file. The model contains four tags, all of which are logged for 
every snapshot. The date format is Default. The example includes three 
snapshots. In Linear with status bits format, the file looks like this: 


89/12/06 12:18:00 DTAGO1 0 01000000 
89/12/06 12:18:00  DTAGO2 4 11000000 
89/12/06 12:18:00  DTAGO3 6 01001000 
89/12/06 12:18:00 STRING.TAG “EMPTY” 01001000 
89/12/06 12:18:10 DTAGO1 0 01000000 
89/12/06 12:18:10 DTAGO2 0 01000000 
89/12/06 12:18:10 DTAGO3 6 01001000 
89/12/06 12:18:10 STRING.TAG “FILLING” 01000000 
89/12/06 12:18:20 DTAGO1 0 01000000 
89/12/06 12:18:20 DTAGO2 0 01000000 
89/12/06 12:18:20 DTAGO3 0 01000000 
89/12/06 12:18:20 STRING.TAG “FILLING” 01000000 


In Linear without status bits format, the file looks like this: 


89/12/06 12:18:00 DTAGO1 0 
89/12/06 12:18:00 DTAGO3 6 
89/12/06 12:18:00 STRING.TAG “EMPTY 
89/12/06 12:18:10 DTAGO1 0 
89/12/06 12:18:10 DTAGO2 0 
89/12/06 12:18:10 DTAGO3 6 
89/12/06 12:18:10 STRING.TAG "FILLING" 
89/12/06 12:18:20 DTAGO1 0 
89/12/06 12:18:20  DTAGO2 0 
89/12/06 12:18:20 DTAGO3 0 


89/12/06 12:18:20 STRING.TAG "FILLING" 


In Columnar format, the file looks like this: 


89/12/06 12:18:00 ,0,,6," EMPTY” 
89/12/06 12:18:10 .,0,0,6,"FILLING" 
89/12/06 12:18:20 .,0,0,0,"FILLING" 


Notice in the second and third examples, there is nothing recorded for the 
first snapshot of DTAGO2. This is because the tag recorded a 
communication fault (the first bit is set to one in the first sample) during 
this snapshot. 
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Example: Exporting a File to This section gives a brief explanation of how a Data Logger file can be 
dBASE imported into a database created in dBASE IV®. The basic steps used are: 


1. Export the Data Logger data to two ASCII text files: one for numeric 
data, the other for string data. This example uses the Linear with 
status bit format, but you can use any of the formats. 


This involves creating two export templates, one with a tag list of all 
the digital and analog tags, the other with a tag list of all the string 
tags. The data must be split into separate files since dBASE can’t 
import a file with both numeric and string data in the value field. 


Follow the instructions presented earlier in this Appendix for details. 
For this example, assume the exported ASCII files are called 
NUM. OUT, and STR OUT. 

2. Create two databases in dBASE. 


3. Import the ASCII files into dBASE with dBASE's APPEND 
command. 


This example is as simple as possible in order to keep it short. You must 
already know dBASE so that you can expand on this example. O 


Create the Database in dBASE 


Create two databases in dBASE with these formats. The field names are 
arbitrary, and may be whatever is needed. 


Table B.D 
Database Format for Numeric Data 


COMM_ERROR Numeric 
ON_SCAN 


ALM_LEVEL 


ALM_ACK 
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Table B.E 
Database Format for String Data 


DATE Character 


LIN 
fine owe [e 


[E [ewm —— [m — 
ue ——— mme EE 
Rowe [Ronee CO 
usw fuer || 
purs — mee | 
CEDER E [1 — 
pucr wee | 
Durs —— quee — | 
pure. qune — Ti — 
mark — — ume — i 


To create a database called LOG NUM, from dBASE's dot prompt type 
the following command: 


CREATE LOG NUM 
dBASE will then present you with a screen that allows you to define each 


field in the database. Use the CREATE command to create the second 
database called LOG. STR. 


Import the File into dBASE 


The final step is to import the ASCII files into the dBASE databases. To 
import a file called LOG NUM, follow these steps: 


1. Tell dBASE which database you are using with dBASE's USE 
command. For the database called LOG NUM, you'd type: 


USE LOG NUM 

2. Import the file with dBASE's APPEND command, like this: 
APPEND FROM num out DELIMITED WITH BLANK 

The Data Logger numeric data is now in a dBASE file. Repeat these two 


steps using the LOG STR database and appending from STR, OUT to 
import the string data. 
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Configuring Data Logger Efficiently 


Here are some general guidelines for configuring Data Logger: 


a Do not log data faster than the data changes. For example, if a tag is 
scanned only once a minute, there is no need to log it once every 
second. 


= Consider using the DATALOGSNAPSHOT command along with the 
Event Detector to log only on an event. 


= Other options which use Data Logger files, such as Trending and 
Statistical Process Control, can access a large number of small Data 
Logger files more efficiently than a small number of large files. For 
example, 200 10K files are more efficient than 20 100K files. 


You can have from 4 to 200 files per model, and each file can be 
anywhere from 1 to 4000 Kb in size. It follows, then, that the smallest a 
model could be is 4 Kb (4 files X 1 Kb each), and the largest a model 
could be is 800 Mb (200 files X 4,000 Kb each). 


= Consider keeping only the data you need in the log files and exporting 
or archiving old data if it is no longer required. For example if the 
operator needs to look at logged data that is a maximum of three weeks 
old, configure the log files to hold only three weeks data, and export or 
archive the old data if it may be needed later. 


= Using DOS 5.0 it is possible to use SMARTDRV.SYS to set up disk 
caching. This can speed up ControlView's disk access and improve 
performance. 
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